IRIX Base Documentation 2002 November/SGI IRIX Base Documentation 2002 November.iso/usr/share/catman/g_man/cat3/OpenGL-ftn/fglubuild2dmipmaplevels.z/fglubuild2dmipmaplevels

Text File | 2002-10-03 | 22.8 KB | 199 lines

ffffgggglllluuuuBBBBuuuuiiiilllldddd2222DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss((((3333GGGG))))    OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee    ffffgggglllluuuuBBBBuuuuiiiilllldddd2222DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss((((3333GGGG))))



NNNNAAAAMMMMEEEE
     ffffgggglllluuuuBBBBuuuuiiiilllldddd2222DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss - builds a subset of two-dimensional mipmap
     levels


FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
     INTEGER*4 ffffgggglllluuuuBBBBuuuuiiiilllldddd2222DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss( INTEGER*4 _t_a_r_g_e_t,
                                        INTEGER*4 _i_n_t_e_r_n_a_l_F_o_r_m_a_t,
                                        INTEGER*4 _w_i_d_t_h,
                                        INTEGER*4 _h_e_i_g_h_t,
                                        INTEGER*4 _f_o_r_m_a_t,
                                        INTEGER*4 _t_y_p_e,
                                        INTEGER*4 _l_e_v_e_l,
                                        INTEGER*4 _b_a_s_e,
                                        INTEGER*4 _m_a_x,
                                        void _d_a_t_a )


PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
     _t_a_r_g_e_t          Specifies the target texture.  Must be GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD.

     _i_n_t_e_r_n_a_l_F_o_r_m_a_t  Requests the internal storage format of the texture
                     image.  Must be 1, 2, 3, 4, or one of the following
                     symbolic constants:  GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____AAAALLLLPPPPHHHHAAAA8888,
                     GGGGLLLL____AAAALLLLPPPPHHHHAAAA11112222, GGGGLLLL____AAAALLLLPPPPHHHHAAAA11116666, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444,
                     GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666,
                     GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____AAAALLLLPPPPHHHHAAAA4444,
                     GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE6666____AAAALLLLPPPPHHHHAAAA2222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____AAAALLLLPPPPHHHHAAAA8888,
                     GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA11112222,
                     GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____AAAALLLLPPPPHHHHAAAA11116666, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY4444,
                     GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY8888, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11112222, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11116666, GGGGLLLL____RRRRGGGGBBBB,
                     GGGGLLLL____RRRR3333____GGGG3333____BBBB2222, GGGGLLLL____RRRRGGGGBBBB4444, GGGGLLLL____RRRRGGGGBBBB5555, GGGGLLLL____RRRRGGGGBBBB8888, GGGGLLLL____RRRRGGGGBBBB11110000,
                     GGGGLLLL____RRRRGGGGBBBB11112222, GGGGLLLL____RRRRGGGGBBBB11116666, GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____RRRRGGGGBBBBAAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA4444,
                     GGGGLLLL____RRRRGGGGBBBB5555____AAAA1111, GGGGLLLL____RRRRGGGGBBBBAAAA8888, GGGGLLLL____RRRRGGGGBBBB11110000____AAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA11112222 or
                     GGGGLLLL____RRRRGGGGBBBBAAAA11116666.

     _w_i_d_t_h, _h_e_i_g_h_t   Specifies the width and height, respectively, in pixels
                     of the texture image. These should be a power of 2.

     _f_o_r_m_a_t          Specifies the format of the pixel data.  Must be one of
                     GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX, GGGGLLLL____DDDDEEEEPPPPTTTTHHHH____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT, GGGGLLLL____RRRREEEEDDDD, GGGGLLLL____GGGGRRRREEEEEEEENNNN,
                     GGGGLLLL____BBBBLLLLUUUUEEEE, GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____RRRRGGGGBBBB, GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____BBBBGGGGRRRR, GGGGLLLL____BBBBGGGGRRRRAAAA,
                     GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, or GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA.

     _t_y_p_e            Specifies the data type for _d_a_t_a.  Must be one of
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____BBBBYYYYTTTTEEEE, GGGGLLLL____BBBBIIIITTTTMMMMAAAAPPPP, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT,
                     GGGGLLLL____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT, GGGGLLLL____IIIINNNNTTTT, GGGGLLLL____FFFFLLLLOOOOAAAATTTT,
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV,
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV,
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV,
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV,
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV,



                                                                        PPPPaaaaggggeeee 1111






ffffgggglllluuuuBBBBuuuuiiiilllldddd2222DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss((((3333GGGG))))    OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee    ffffgggglllluuuuBBBBuuuuiiiilllldddd2222DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss((((3333GGGG))))



                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222 or
                     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV.

     _l_e_v_e_l           Specifies the mipmap level of the image data.

     _b_a_s_e            Specifies the minimum mipmap level to pass to
                     ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD.

     _m_a_x             Specifies the maximum mipmap level to pass to
                     ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD.

     _d_a_t_a            Specifies a pointer to the image data in memory.

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     ffffgggglllluuuuBBBBuuuuiiiilllldddd2222DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss builds a subset of prefiltered two-dimensional
     texture maps of decreasing resolutions called a mipmap. This is used for
     the antialiasing of texture mapped primitives.

     A return value of zero indicates success, otherwise a GLU error code is
     returned (see ffffgggglllluuuuEEEErrrrrrrroooorrrrSSSSttttrrrriiiinnnngggg).

     A series of mipmap levels from _b_a_s_e to _m_a_x is built by decimating _d_a_t_a in
     half along both dimensions until size 1 x 1 is reached. At each level,
     each texel in the halved mipmap level is an average of the corresponding
     four texels in the larger mipmap level. (In the case of rectangular
     images, the decimation will ultimately reach an N x 1 or 1 x N
     configuration. Here, two texels are averaged instead.)  ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD is
     called to load these mipmap levels from _b_a_s_e to _m_a_x. If _m_a_x is larger
     than the highest mipmap level for the texture of the specified size, then
     a GLU error code is returned (see ffffgggglllluuuuEEEErrrrrrrroooorrrrSSSSttttrrrriiiinnnngggg) and nothing is loaded.

     For example, if _l_e_v_e_l is 2 and _w_i_d_t_h is 16 and _h_e_i_g_h_t is 8, the following
     levels are possible: 16 x 8, 8 x 4, 4 x 2, 2 x 1, 1 x 1. These correspond
     to levels 2 through 6 respectively.  If _b_a_s_e is 3 and _m_a_x is 5, then only
     mipmap levels 8 x 4, 4 x 2 and 2 x 1 are loaded. However, if _m_a_x is 7
     then an error is returned and nothing is loaded since _m_a_x is larger than
     the highest mipmap level which is, in this case, 6.

     The highest mipmap level can be derived from the formula
     log2(max(_w_i_d_t_h,_h_e_i_g_h_t)*(2^_l_e_v_e_l)).

     See the ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD reference page for a description of the acceptable
     values for _f_o_r_m_a_t parameter. See the ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss reference page for a
     description of the acceptable values for _t_y_p_e parameter.

NNNNOOOOTTTTEEEESSSS
     ffffgggglllluuuuBBBBuuuuiiiilllldddd2222DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss is only available if the GLU version is 1.3 or
     greater.

     Formats GGGGLLLL____BBBBGGGGRRRR, and GGGGLLLL____BBBBGGGGRRRRAAAA, and types GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222,
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555,
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444,



                                                                        PPPPaaaaggggeeee 2222






ffffgggglllluuuuBBBBuuuuiiiilllldddd2222DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss((((3333GGGG))))    OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee    ffffgggglllluuuuBBBBuuuuiiiilllldddd2222DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss((((3333GGGG))))



     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111,
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888,
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222, and
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV are only available if the GL version is
     1.2 or greater.

EEEERRRRRRRROOOORRRRSSSS
     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is returned if _l_e_v_e_l > _b_a_s_e, _b_a_s_e < 0, _m_a_x < _b_a_s_e or
     _m_a_x is > the highest mipmap level for _d_a_t_a.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is returned if _w_i_d_t_h or _h_e_i_g_h_t is < 1.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is returned if _i_n_t_e_r_n_a_l_F_o_r_m_a_t, _f_o_r_m_a_t, or _t_y_p_e is not
     legal.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is returned if _t_y_p_e is GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222 or
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV and _f_o_r_m_a_t is not GGGGLLLL____RRRRGGGGBBBB.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is returned if _t_y_p_e is GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555 or
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV and _f_o_r_m_a_t is not GGGGLLLL____RRRRGGGGBBBB.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is returned if _t_y_p_e is GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444 or
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV and _f_o_r_m_a_t is neither GGGGLLLL____RRRRGGGGBBBBAAAA nor GGGGLLLL____BBBBGGGGRRRRAAAA.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is returned if _t_y_p_e is GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111 or
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV and _f_o_r_m_a_t is neither GGGGLLLL____RRRRGGGGBBBBAAAA nor GGGGLLLL____BBBBGGGGRRRRAAAA.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is returned if _t_y_p_e is GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888 or
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV and _f_o_r_m_a_t is neither GGGGLLLL____RRRRGGGGBBBBAAAA nor GGGGLLLL____BBBBGGGGRRRRAAAA.

     GGGGLLLLUUUU____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is returned if _t_y_p_e is GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222
     or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV and _f_o_r_m_a_t is neither GGGGLLLL____RRRRGGGGBBBBAAAA nor
     GGGGLLLL____BBBBGGGGRRRRAAAA.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD,
     ffffgggglllluuuuBBBBuuuuiiiilllldddd1111DDDDMMMMiiiippppmmmmaaaappppssss, ffffgggglllluuuuBBBBuuuuiiiilllldddd2222DDDDMMMMiiiippppmmmmaaaappppssss, ffffgggglllluuuuBBBBuuuuiiiilllldddd3333DDDDMMMMiiiippppmmmmaaaappppssss,
     ffffgggglllluuuuEEEErrrrrrrroooorrrrSSSSttttrrrriiiinnnngggg, ggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee, ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr,
     ffffgggglllluuuuBBBBuuuuiiiilllldddd1111DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss, ffffgggglllluuuuBBBBuuuuiiiilllldddd3333DDDDMMMMiiiippppmmmmaaaappppLLLLeeeevvvveeeellllssss
















                                                                        PPPPaaaaggggeeee 3333